Improve the docs. (#486155, Owen Taylor)

2007-10-16  Matthias Clasen <mclasen@redhat.com>

        * gtk/gtktextiter.c (gtk_text_iter_forward_line): Improve
        the docs.  (#486155, Owen Taylor)

svn path=/trunk/; revision=18914

diff --git a/ChangeLog b/ChangeLog
index a8eb8409c72902b139bd34a9be82959449ee0c28..d7894cdeff667fc50cf5e8fc6cdf32f7abef10bc 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2007-10-16  Matthias Clasen <mclasen@redhat.com>
+
+       * gtk/gtktextiter.c (gtk_text_iter_forward_line): Improve 
+       the docs.  (#486155, Owen Taylor)
+
 2007-10-16  Matthias Clasen <mclasen@redhat.com>
 
        * tests/testxinerama.c: Change testcase to not update

diff --git a/gtk/gtktextiter.c b/gtk/gtktextiter.c
index a23d02b2c886bf22269eb99c2382c8d5de7af8a8..715f7e596496632f3a87bf52e8b0c80105c2cdc2 100644 (file)
--- a/gtk/gtktextiter.c
+++ b/gtk/gtktextiter.c
@@ -2479,10 +2479,10 @@ gtk_text_iter_backward_text_chars (GtkTextIter *iter,
  * gtk_text_iter_forward_line:
  * @iter: an iterator
  *
- * Moves @iter to the start of the next line. Returns %TRUE if there
- * was a next line to move to, and %FALSE if @iter was simply moved to
- * the end of the buffer and is now not dereferenceable, or if @iter was
- * already at the end of the buffer.
+ * Moves @iter to the start of the next line. If the iter is already on the
+ * last line of the buffer, moves the iter to the end of the current line.
+ * If after the operation, the iter is at the end of the buffer and not
+ * dereferencable, returns %FALSE. Otherwise, returns %TRUE.
  *
  * Return value: whether @iter can be dereferenced
  **/